home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / defpattern.z / defpattern
Text File  |  1998-10-20  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddeeeeffffppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))                                                  ddddeeeeffffppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddeeeeffffppppaaaatttttttteeeerrrrnnnn - defines patterns
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ddddeeeeffffppppaaaatttttttteeeerrrrnnnn((((nnnn,,,, ssssiiiizzzzeeee,,,, mmmmaaaasssskkkk))))
  13.      sssshhhhoooorrrrtttt nnnn,,,, ssssiiiizzzzeeee;;;;
  14.      uuuunnnnssssiiiiggggnnnneeeedddd sssshhhhoooorrrrtttt mmmmaaaasssskkkk[[[[]]]];;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _n      expects the constant that you want to use as an identifier for the
  18.             pattern described by _m_a_s_k.  This constant is used as an index into
  19.             a table of patterns. By default, pattern 0 is a 16X16 solid
  20.             pattern that cannot be changed.
  21.  
  22.      _s_i_z_e   expects the size of the pattern: 16, 32, or 64 for a 16x16-,
  23.             32x32-, or 64x64-bit pattern, respectively.
  24.  
  25.      _m_a_s_k   expects an array of 16-bit integers that form the actual bit
  26.             pattern.  The system stores the pattern in a pattern table at
  27.             index _n.  The pattern is described from left to right and bottom
  28.             to top, just as characters are described in a raster font.
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      ddddeeeeffffppppaaaatttttttteeeerrrrnnnn allows you to define an arbitrary pattern and assign it an
  32.      identifier. You can later reference this pattern in other routines via
  33.      its identifier.  Patterns are available to all windows when using
  34.      multiple windows.
  35.  
  36.      Patterns affect the filling of polygons, including rectangles, arcs, and
  37.      circles, as well as polygons specified with individual vertices.  They
  38.      also affect the filling of the window when _c_l_e_a_r(3g) is called.  Patterns
  39.      have no effect on the scan conversion of points, lines, or characters, or
  40.      on pixel write or copy operations.
  41.  
  42.      When a pattern is active (see sssseeeettttppppaaaatttttttteeeerrrrnnnn), it is effectively replicated
  43.      across the entire screen, with the edges of pattern tiles aligned to the
  44.      left and bottom edges of the screen.  Bit 15 of each 16-bit description
  45.      word is leftmost, and words are assembled left to right, then bottom to
  46.      top, to form each pattern square.  Pixels on the screen that correspond
  47.      to zeros in the pattern remain unmodified during scan conversion of
  48.      polygons.  No changes are made to any bitplane bank of a protected pixel.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      deflinestyle, defrasterfont, getpattern, setpattern
  52.  
  53. NNNNOOOOTTTTEEEESSSS
  54.      This routine is available only in immediate mode.
  55.  
  56.      Some machines do not support 64x64 patterns.  Call
  57.      ggggeeeettttggggddddeeeesssscccc((((GGGGDDDD____PPPPAAAATTTTSSSSIIIIZZZZEEEE____66664444)))) to determine the availability of 64x64 patterns.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddeeeeffffppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))                                                  ddddeeeeffffppppaaaatttttttteeeerrrrnnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      There is a performance penalty on the Personal Iris for non-solid
  75.      patterns.
  76.  
  77.      When ddddeeeeffffppppaaaatttttttteeeerrrrnnnn is used to modify the current pattern, the new pattern
  78.      becomes current only when sssseeeettttppppaaaatttttttteeeerrrrnnnn is called again.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.